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Status of this Memo 


This document specifies an Internet standards track protocol for the 
Internet community, and requests discussion and suggestions for 


improvements. Please refer to the current edition of the "Internet 
Official Protocol Standards" (STD 1) for the standardization state 
and status of this protocol. Distribution of this memo is unlimited. 


Copyright Notice 
Copyright (C) The Internet Society (2000). All Rights Reserved. 
Abstract 
This document specifies an authentication scheme for the Telnet 
protocol under the framework described in [RFC2941], using the Secure 
Remote Password Protocol (SRP) authentication mechanism. The 
specific mechanism, SRP-SHA1, is described in [RFC2945]. 
1. Command Names and Codes 
Authentication Types 
SRP 5 
Suboption Commands 
AUTH 


0 

REJECT 1 
ACCEPT 2 
3 

4 


Gl 


CHALLENG 
RESPONSE 


EXP 
PARAMS 


Oo © 
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2. Command Meanings 
TAC SB AUTHENTICATION IS <authentication-type-pair> AUTH IAC SE 


This command indicates that the client has supplied the 
username and is ready to receive that user’s field parameters. 
There is no authentication information to be sent to the remote 
side of the connection yet. This should only be sent after the 
IAC SB AUTHENTICATION NAME command has been issued. If the 
modifier byte (second byte of the authentication-type-pair) 

has any bits other than AUTH_WHO_MASK or AUTH_HOW_MASK set, 

both bytes are included in the session key hash described later. 
This ensures that the authentication type pair was correctly 
negotiated, while maintaining backward-compatibility with existing 
software. 


TAC SB AUTHENTICATION REPLY <authentication-type-pair> PARAMS <values 
of modulus, generator, and salt> IAC SE 


This command is used to pass the three parameter values used 
in the exponentiation to the client. These values are often 
called n, g, and s. 


TAC SB AUTHENTICATION IS <authentication-type-pair> EXP <client’s 
exponential residue> IAC SE 


This command is used to pass the client’s exponential residue, 
otherwise known as A, computed against the parameters exchanged 
earlier. 


TAC SB AUTHENTICATION REPLY <authentication-type-pair> CHALLENGE 
<server’s exponential residue> IAC SE 


This command is used to pass the server’s exponential residue, 
computed against the same parameters. This quantity is actually 
the sum of two residues, i.e. g*x + g*b. For details see [SRP] 
and [RFC2945]. 


TAC SB AUTHENTICATION IS <authentication-type-pair> RESPONSE 
<response from client> IAC SE 


This command gives the server proof of the client’s authenticity 
with a 160-bit (20 byte) response. 


Wu Standards Track [Page 2] 


RFC 2944 Telnet Authentication: SRP September 2000 


Wu 


TAC SB AUTHENTICATION REPLY <authentication-type-pair> ACCEPT 
<server’s response> IAC SE 


This command indicates that the authentication was successful. 
The server will construct its own proof of authenticity and 
include it as sub-option data. 


TAC SB AUTHENTICATION REPLY <authentication-type-pair> REJECT 
<optional reason for rejection> IAC SE 


This command indicates that the authentication was not successful, 
and if there is any more data in the sub-option, it is an ASCII 
text message of the reason for the rejection. 


For the PARAMS command, since three pieces of data are being 
transmitted, each parameter is preceded by a 16-bit (two byte) length 
specifier in network byte order. The EXP commands do not have a 
count in front of the data because there is only one piece of data in 
that suboption. The CHALLENGE, RESPONSE, and ACCEPT data also do not 
have a count because they are all fixed in size. 


Implementation Rules 


Currently, only AUTH_CLIENT_TO_SERVER mode is supported. Although 
the SRP protocol effectively performs implicit mutual authentication 
as a result of the two-way proofs, only the AUTH_HOW_ONE_WAY 
authentication mode is currently defined. The AUTH_HOW_MUTUAL 
setting is being reserved for an explicit mutual-authentication 
variant of the SRP protocol to be defined in future specifications. 


All large number data sent in the arguments of the PARAMS and EXP 
commands must be in network byte order, i.e. most significant byte 
first. No padding is used. 


The SRP-SHA1 mechanism, as described in [RFC2945] generates a 40-byte 
session key, which allows implementations to use different keys for 
incoming and outgoing traffic, increasing the security of the 
encrypted session. It is recommended that the Telnet ENCRYPT method, 
if it is used, be able to take advantage of the longer session keys. 


Examples 


User "tjw" may wish to log in on machine "foo". The client would 
send IAC SB AUTHENTICATION NAME "tjw" IAC SE IAC SB AUTHENTICATION IS 
SRP AUTH IAC SE. The server would look up the field and salt 
parameters for "tjw" from its password file and send them back to the 
client. Client and server would then exchange exponential residues 
and calculate their session keys (after the client prompted "tjw" for 
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his password). Then, the client would send the server its proof that 
it knows the session key. The server would either send back an 
ACCEPT or a REJECT. If the server accepts authentication, it also 
sends its own proof that it knows the session key to the client. 


Client Server 
IAC DO AUTHENTICATION 
TAC WILL AUTHENTICATION 


[ The server is now free to request authentication information. 
] 
TAC SB AUTHENTICATION SEND 
SRP CLIENT | ONE_WAY 
ENCRYPT_USING_TELOPT 
SRP CLIENT | ONE_WAY 
IAC SE 


[ The server has requested SRP authentication. It has indicated 
a preference for ENCRYPT_USING_TELOPT, which requires the 
Telnet ENCRYPT option to be negotiated once authentication 
succeeds. If the client does not support this, the server 
is willing to fall back to an encryption-optional mode. 


The client will now respond with the name of the 
user that it wants to log in as. ] 


IAC SB AUTHENTICATION NAME 
"tjw" IAC SE 

IAC SB AUTHENTICATION IS 

SRP CLIENT |ONE_WAY|ENCRYPT_USING_TELOPT AUTH 
IAC SE 


[ The server looks up the appropriate information for "tjw" and 
sends back the parameters in a PARAMS command. The parameters 
consist of the values N, g, and s, each preceded with a two- 
byte size parameter. ] 


IAC SB AUTHENTICATION REPLY 
SRP CLIENT |ONE_WAY | 
ENCRYPT_USING_TELOPT PARAMS 
SS ss NN NN NN nn 

ss ss gg 99 99 99 

ss ss tt tt tt tt 

IAC SE 
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[ Both sides send their exponential residues. The client 
sends its value A and the server sends its value B. In SRP, 
the CHALLENGE message may be computed but not sent before 
the EXP command. ] 


IAC SB AUTHENTICATION IS 

SRP CLIENT ONE_WAY | ENCRYPT_USING_TELOPT EXP 
aa aa aa aa aa aa aa aa 

IAC SE 


IAC SB AUTHENTICATION REPLY 
SRP CLIENT | ONE_WAY | 
ENCRYPT_USING_TELOPT CHALLENGE 
bb bb bb bb bb bb bb bb 

IAC SE 


[ The client sends its response to the server. This is the 
message M in the SRP protocol, which proves possession of 
the session key by the client. 


Since ENCRYPT_USING_TELOPT is specified, the two octets 
of the authentication-type-pair are appended to the 
session key K before the hash for M is computed. If 
the client and server had agreed upon a mode without 
the encryption flag set, nothing would be appended to K. 


Both this message and the server’s response are as long as 
the output of the hash; the length is 20 bytes for SHA-1. ] 


IAC SB AUTHENTICATION IS 

SRP CLIENT | ONE_WAY ENCRYPT_USING_TELOPT RESPONSE 
XX XX XX XX XX XX XX XX 

IAC SE 


[ The server accepts the response and sends its own proof. ] 


IAC SB AUTHENTICATION REPLY 
SRP CLIENT | ONE_WAY | 
ENCRYPT_USING_TELOPT ACCEPT 


VY¥-Y¥ YY--YY: YY YY- VY YY 
IAC SE 
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5. Security Considerations 


The ability to negotiate a common authentication mechanism between 
client and server is a feature of the authentication option that 
should be used with caution. When the negotiation is performed, no 
authentication has yet occurred. Therefore, each system has no way 
of knowing whether or not it is talking to the system it intends. An 
intruder could attempt to negotiate the use of an authentication 
system which is either weak, or already compromised by the intruder. 


Since SRP relies on the security of the underlying public-key 
cryptosystem, the modulus "n" should be large enough to resist 
brute-force attack. A length of at least 1024 bits is recommended, 
and implementations should reject attempts to use moduli that are 
shorter than 512 bits, or attempts to use invalid moduli and 
generator parameters (non-safe-prime "n" or non-primitive "g"). 


6. IANA Considerations 


The authentication type SRP and its associated suboption values are 
registered with IANA. Any suboption values used to extend the 
protocol as described in this document must be registered with IANA 
before use. IANA is instructed not to issue new suboption values 
without submission of documentation of their use. 
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Full Copyright Statement 
Copyright (C) The Internet Society (2000). All Rights Reserved. 


This document and translations of it may be copied and furnished to 
others, and derivative works that comment on or otherwise explain it 
or assist in its implementation may be prepared, copied, published 
and distributed, in whole or in part, without restriction of any 
kind, provided that the above copyright notice and this paragraph are 
included on all such copies and derivative works. However, this 
document itself may not be modified in any way, such as by removing 
the copyright notice or references to the Internet Society or other 
Internet organizations, except as needed for the purpose of 
developing Internet standards in which case the procedures for 
copyrights defined in the Internet Standards process must be 
followed, or as required to translate it into languages other than 
English. 


The limited permissions granted above are perpetual and will not be 
revoked by the Internet Society or its successors or assigns. 


This document and the information contained herein is provided on an 
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 


Acknowledgement 


Wu 


Funding for the RFC Editor function is currently provided by the 
Internet Society. 


Standards Track [Page 7] 


